How to Set Up Proxy Server Service to use SSL for REST API Requests

Use the following steps to set up Proxy Server Service to use SSL for REST API:

Modify proxyserver_jar.properties
1. stop Prizm Proxy Server service using Windows Services management tool
2. open proxyserver_jar.properties in a text editor and set
  http_ssl_enabled=true
3. save and close proxyserver_jar.properties
Modify prizmconfig.xml in your sample root folder and set
1. open prizmconfig.xml in XML editor or text editor and set
  <WebServiceScheme>https</WebServiceScheme>
Start Prizm Proxy Server service using Windows Services management tool
Check logs at <prizm-install>\logs\proxyserver.log

SSL mode is denoted in proxyserver.log at initialization phase, e.g..:

INFO | jvm 1 | 2012/09/10 08:00:26 | http server ssl enabled : true
INFO | jvm 1 | 2012/09/10 08:00:26 | http server ssl keystore : C:/Prizm/bin/proxyserver_ssc.jks
INFO | jvm 1 | 2012/09/10 08:00:26 | http server ssl password : ****************
:
INFO | jvm 1 | 2012/09/10 08:00:38 | [ info ] [https-server] starting...
INFO | jvm 1 | 2012/09/10 08:00:38 | [ info ] [https-server] adding to the pool: worker-0
INFO | jvm 1 | 2012/09/10 08:00:39 | [ info ] [https-server] binded to: ssl socket,host=localhost,port=18680

[https-server] with each client request, similar to this:
INFO | jvm 1 | 20012/09/10 08:00:56 | [ info ] [https-server] [worker-0] handling client request

Performing REST API calls in SSL Mode

After enabling SSL it is necessary to call REST API using HTTPS protocol, e.g.:

Command line API

java -jar cconvert2swfclient.jar proxyserver=https://localhost:18680 source=c:\temp\sample.doc

REST API

https://localhost:18680/convert2swf?source=c:\temp\sample.doc

What is proxyserver_ssc.jks?

This file is called keystore. It is necessary for SSL handshake phase and data encryption.

proxyserver_ssc.jks contains self-signed certificate that is intended to be used in trusted environments (difficult to tamper), such as localhost or intranets.

It can be located in <prizm-install>\bin\ folder.

To print the content of the keystore you may use following command:

keytool -list -v -keystore <prizm-install>\bin\proxyserver_ssc.jks -storepass "password"

The location of the keystore file and keystore password is defined in proxyserver_jar.properties file:

# http SSL keystore file path
http_ssl_keystore_file=proxyserver_ssc.jks
# http SSL keystore password
http_ssl_keystore_pass=password